home *** CD-ROM | disk | FTP | other *** search
/ Apple WWDC 1996 / WWDC96_1996 (CD).toast / Technology Materials / MacOS 8 Resources / Developer Tools / Mac OS 8 Interfaces & Libraries / Interfaces / AIncludes / TextInputSystem.a < prev    next >
Text File  |  1996-05-01  |  5KB  |  147 lines
  1. ;
  2. ;    File:        TextInputSystem.a
  3. ;
  4. ;    Contains:    The handling of text input user interface.
  5. ;
  6. ;    Version:    Technology:    System 8
  7. ;                Release:    Universal Interfaces 3.0d3 on Copland DR1
  8. ;
  9. ;    Copyright:    © 1984-1996 by Apple Computer, Inc.  All rights reserved.
  10. ;
  11. ;    Bugs?:        If you find a problem with this file, send the file and version
  12. ;                information (from above) and the problem description to:
  13. ;
  14. ;                    Internet:    apple.bugs@applelink.apple.com
  15. ;                    AppleLink:    APPLE.BUGS
  16. ;
  17. ;
  18.     IF &TYPE('__TEXTINPUTSYSTEM__') = 'UNDEFINED' THEN
  19. __TEXTINPUTSYSTEM__ SET 1
  20.  
  21.     IF &TYPE('__TYPES__') = 'UNDEFINED' THEN
  22.     include 'Types.a'
  23.     ENDIF
  24.     IF &TYPE('__TEXTCOMMON__') = 'UNDEFINED' THEN
  25.     include 'TextCommon.a'
  26.     ENDIF
  27.     IF &TYPE('__LOCALEOBJECTS__') = 'UNDEFINED' THEN
  28.     include 'LocaleObjects.a'
  29.     ENDIF
  30.     IF FOR_SYSTEM8_COOPERATIVE THEN
  31. ; ____________________________________________________________________________________
  32. ;
  33. ;
  34. ;Routine:    GetCurrentTextInputLocaleIdentifier
  35. ;            gets the LocaleIdentifier of the currently selected text input object.
  36. ;Input:        NONE.
  37. ;Output:        langRegionCode: the currently selected object.
  38. ;OSStatus:    (no error, ?)
  39. ;NOTE:        System8 only.
  40. ;
  41. ;
  42. ;
  43. ; extern OSStatus GetCurrentTextInputLocaleIdentifier(LocaleIdentifier *langRegionCode)
  44. ;
  45.     IF GENERATINGCFM THEN
  46.         IMPORT_CFM_FUNCTION GetCurrentTextInputLocaleIdentifier
  47.     ENDIF
  48.  
  49. ; ____________________________________________________________________________________
  50. ;
  51. ;
  52. ;Routine:    GetCurrentTextInputRef
  53. ;            gets the current text input object reference.
  54. ;Input:        NONE.
  55. ;Output:        textInputObject: the currently selected object.
  56. ;OSStatus:    (no error, ?)
  57. ;NOTE:        System8 only.
  58. ;
  59. ;
  60. ; extern OSStatus GetCurrentTextInputRef(LocaleObjectRef *textInputObject)
  61. ;
  62.     IF GENERATINGCFM THEN
  63.         IMPORT_CFM_FUNCTION GetCurrentTextInputRef
  64.     ENDIF
  65.  
  66. ; ____________________________________________________________________________________
  67. ;
  68. ;
  69. ;Routine:    SetCurrentTextInputLocaleIdentifier
  70. ;            sets the current text input object according to the passed-in LocaleIdentifier.
  71. ;Input:        textInputObject: the object selected by the client.
  72. ;Output:        NONE.
  73. ;OSStatus:    (no error, invalide object)
  74. ;NOTE:        if the object is not shown, it will be displayed in the menu if the system supports
  75. ;            this language/region/... locale.
  76. ;
  77. ;
  78. ;
  79. ; extern OSStatus SetCurrentTextInputLocaleIdentifier(LocaleIdentifier langRegionCode)
  80. ;
  81.     IF GENERATINGCFM THEN
  82.         IMPORT_CFM_FUNCTION SetCurrentTextInputLocaleIdentifier
  83.     ENDIF
  84.  
  85. ; ____________________________________________________________________________________
  86. ;
  87. ;
  88. ;Routine:    SetCurrentTextInputRef
  89. ;            sets the current text input object ref.
  90. ;Input:        textInputObject: the object selected by the client.
  91. ;Output:        NONE.
  92. ;OSStatus:    (no error, invalide object)
  93. ;NOTE:        if the object is not shown, it will be displayed in the menu if the system supports
  94. ;            this language/region/... locale.
  95. ;
  96. ;
  97. ; extern OSStatus SetCurrentTextInputRef(LocaleObjectRef textInputObject)
  98. ;
  99.     IF GENERATINGCFM THEN
  100.         IMPORT_CFM_FUNCTION SetCurrentTextInputRef
  101.     ENDIF
  102.  
  103. ;
  104. ;____________________________________________________________________________________
  105. ;    routines for converting between a text input object ref and the new LocaleIdentifier
  106. ;____________________________________________________________________________________
  107. ;
  108. ;
  109. ;
  110. ;Routine:    GetLocaleIdentifierFromTextInputObjectRef
  111. ;            returns the LocaleIdentifier textInputObject represents.
  112. ;Input:        textInputObject:    the reference of text input object.
  113. ;Output:        langRegionCode:        localeIdentifier that this objects is stamped with.
  114. ;OSStatus:    (no error, ?)
  115. ;NOTE:        System8 only.
  116. ;
  117. ;
  118. ;
  119. ; extern OSStatus GetLocaleIdentifierFromTextInputObjectRef(LocaleObjectRef textInputObject, LocaleIdentifier *langRegionCode)
  120. ;
  121.     IF GENERATINGCFM THEN
  122.         IMPORT_CFM_FUNCTION GetLocaleIdentifierFromTextInputObjectRef
  123.     ENDIF
  124.  
  125. ; ____________________________________________________________________________________
  126. ;
  127. ;
  128. ;Routine:    GetTextInputObjectRefFromLocaleIdentifier
  129. ;            gets the object ref last designated by the user as representing the lanaguag/region
  130. ;            LocaleIdentifier (or simply returns the default one), otherwise it returns null.
  131. ;Input:        langRegioncode:        value of LocaleIdentifier.
  132. ;Output:        textInputObject:    best match returned object.
  133. ;OSStatus:    (no error, ?)
  134. ;NOTE:        System8 only.
  135. ;
  136. ;
  137. ;
  138. ; extern OSStatus GetTextInputObjectRefFromLocaleIdentifier(LocaleIdentifier langRegionCode, LocaleObjectRef *textInputObject)
  139. ;
  140.     IF GENERATINGCFM THEN
  141.         IMPORT_CFM_FUNCTION GetTextInputObjectRefFromLocaleIdentifier
  142.     ENDIF
  143.  
  144.     ENDIF
  145.     ENDIF ; __TEXTINPUTSYSTEM__ 
  146.  
  147.